home *** CD-ROM | disk | FTP | other *** search
/ 3D GFX / 3D GFX.iso / pcutils / os2 / jview / jvwtxt.hlp (.txt) < prev    next >
Encoding:
OS/2 Help File  |  1995-12-31  |  8.9 KB  |  150 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Text Utility Add on ΓòÉΓòÉΓòÉ
  3.  
  4. The function contained in this DLL are designed to work with the JView imaging 
  5. system.  You will need to reference JView's main help file or the written 
  6. manual that comes with JView for help on controls that are common to all JView 
  7. dialogs, such as the colorwell.  This particular module is provided by: 
  8.  
  9.                                  Crunch Products
  10.                                   P.O. Box 392
  11.                              Berkeley, CA 94701-0392
  12.                                        USA
  13.  
  14.  
  15. ΓòÉΓòÉΓòÉ 1.1. Overview ΓòÉΓòÉΓòÉ
  16.  
  17. The Text Utility's functions are all contained in one dialog that allows you to 
  18. place text on your image.  The design philosophy for this utility has been "The 
  19. user should be given maximum control over the placement and appearance of the 
  20. text."  To achieve this, you have control over each individual character. This 
  21. utility has not been designed for use in working with large amounts of text. 
  22. It is best suited for placing captions, titles, etc. 
  23.  
  24.  
  25. ΓòÉΓòÉΓòÉ 1.2. How to use it ΓòÉΓòÉΓòÉ
  26.  
  27. The first parts to examine are various settings that can be specified for the 
  28. appearance or positioning of the text.  Be aware that the following options are 
  29. applied individually to each character. 
  30.  
  31. Font Name is used to select the font for the text.  These fonts are part of the 
  32. OS/2 system and so can be added or deleted by you at the system level.  For our 
  33. purposes, outline fonts work best because they have the ability to be scaled in 
  34. arbitrary increments and often have rotation and skew capabilities.  Note that 
  35. not all fonts have skew or rotation capability, what you see is what you get. 
  36.  
  37. SizeThis refers to the size of the font when it is displayed. For graphics, you 
  38. will often want sizes that  are much larger than what typically used in word 
  39. processing.  Start with sizes in the 20 to 40 range. 
  40.  
  41. Skew refers to the process of shifting the top of a character left or right 
  42. while keeping the bottom edge fixed (making the character slant).  The number 
  43. you enter here represents the angle that a line drawn on the left edge of the 
  44. character would make with respect to the vertical axis.  It is through skewing 
  45. that italic fonts are created. 
  46.  
  47. Angle indicates the number of degrees that the text will be rotated relative to 
  48. the horizontal axis.  By specifying changing angles you can create a path for 
  49. your text to follow.  For instance, to have your text go up and down a hill, 
  50. begin with an angle of 0.  Character by character increase the angle till you 
  51. reach the middle of your hill's rise then begin decreasing the angle.  At the 
  52. top of the hill the angle should be back to zero.  Follow a similar procedure 
  53. for the downside of the hill. 
  54.  
  55. Xtra X and Xtra Y  allow you to shift a character by the indicated amount (the 
  56. units are pixels).  This gives you fine tuning capability as well as the 
  57. ability to do radical shifts.  Note that these extra spacings when calculating 
  58. the spacing needs for multiple lines of text or when center justification or 
  59. right justification is being used.  Also, the shift caused by moving the 
  60. current character will cause all subsequent characters on the same line to 
  61. shift the same amount.  This is because characters on the same line are printed 
  62. relative to the preceding character. 
  63.  
  64. Orientation.Conventional printing occurs left to right.  For your purposes, 
  65. there are three other options.  Right to left, up to down, and down to up. 
  66.  
  67. Fore, Back and Transparent refer to the color of the text.  These will only 
  68. have an affect if embossing and engraving are not being used.  Fore refers to 
  69. the foreground color of the text or what color the actual character will be. 
  70. Back refers to the background color or the color of the area immediately around 
  71. the character.  Transparent will cause the background color to be ignored and 
  72. the image will show through instead.  You will typically leave transparency on. 
  73.  
  74. Bold, Italic and Underline are well known printing effects.  These are applied 
  75. or removed by checking the appropriate box. 
  76.  
  77. All of the above settings can be changed on a character by character basis, 
  78. Those settings listed below apply to the entire sequence of text. 
  79.  
  80. Shadow creates a shadowing of the text.  You specify the color that you wish 
  81. the shadow to have by manipulating the colorwell. The X and Y variables refer 
  82. to the amount of shift, in pixels, that the shadow will take relative to the 
  83. source text.  Basically, the larger the values, the more pronounced the shadow 
  84. will be.  Note that the shadow effect will not occur if either emboss or 
  85. engrave is selected. 
  86.  
  87. Normal, Emboss, and Engrave dictate how the text will be presented.  Normal 
  88. simply takes the text as you have described it and overlays it onto the image. 
  89. Parts of the image that are beneath the text are obscured.  Emboss and Engrave 
  90. give a three dimensional look to your text and make it appear as if the text 
  91. has been embossed/engraved into your image.  Engraving would be as if someone 
  92. used a chisel to write the text on your image, while embossing is the opposite 
  93. effect.  Embossing/engraving are most effective when you image is neither 
  94. mostly white or mostly black.  The numerical parameter that you set when 
  95. embossing/engraving refers to the perceived depth of the effect - larger means 
  96. more depth. 
  97.  
  98. Your can specify text justification under certain circumstances. First off, 
  99. justification is done relative to the first line, not relative to margins as is 
  100. the case with word processing.  So, if you have chosen center justification, 
  101. the fist line stays in the same position no matter what the length, while the 
  102. second line's positioning is a function of the first line.  The three forms of 
  103. justification - left, right, and center - are only designed to work when 
  104. operating with an orientation of left to right.  Further, a single angle should 
  105. be used for all the characters, although that angle does not need to be zero. 
  106. The type of justification is chosen by pressing the appropriate button. 
  107.  
  108. The Set Startpoint button is used to indicate where placement of the first 
  109. character will be on the image. 
  110.  
  111. The Text Entry Area has the capability to show you exactly what the text will 
  112. look like on your image, with the exception that the color displayed here is 
  113. always black on white with a gray shadow if appropriate.  The text area 
  114. duplicates the size of your image, and so text is placed here at the same 
  115. starting point as occurs on your image.  So, if text is being cutoff because it 
  116. is too large, the same problem will occur on your image.  You will quickly 
  117. observe that text display is somewhat slow.  You can use Draft Mode to display 
  118. text quickly, but the display will no longer be an accurate visual 
  119. representation of the text.  The font and size used to display the text in 
  120. draft mode will be whatever is specified for the first character. 
  121.  
  122. You move around in the text entry area by use of the mouse or the arrow keys. 
  123. Use the shift button in conjunction with the arrow keys to select text for 
  124. modification.  Use the right mouse button to bring up special options. 
  125.  
  126. The following are buttons that are standard to most JView dialogs. 
  127.  
  128. Done  The text utility is exited and the current changes are saved. 
  129.  
  130. Cancel  If text is currently being applied to the image then hitting cancel 
  131. merely aborts the application.  If text is not currently being applied, then 
  132. hitting cancel causes the text utility to exit and all changes to the image are 
  133. discarded. 
  134.  
  135. Undo brings up the undo dialog which allows each different application of text 
  136. to be removed. 
  137.  
  138. Reset will permanently remove the most recent text application. 
  139.  
  140. Load allows you to retrieve a previously saved text segment.  All information 
  141. is saved when a save is performed.  However, it is possible for a previously 
  142. specified font to no longer be available - either because it was deleted from 
  143. the system or you saved the information while on another system.  In these 
  144. cases, a substitute font is used. 
  145.  
  146. Save saves the current text. 
  147.  
  148. Test applies the current text onto the image. 
  149.  
  150. Image makes the image window the currently active window.